home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glgetminmax.z / glgetminmax
Encoding:
Text File  |  2002-10-03  |  12.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx - get minimum and maximum pixel values
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx( GLenum _t_a_r_g_e_t,
  14.                        GLboolean _r_e_s_e_t,
  15.                        GLenum _f_o_r_m_a_t,
  16.                        GLenum _t_y_p_e,
  17.                        GLvoid *_v_a_l_u_e_s )
  18.  
  19.  
  20. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  21.      _t_a_r_g_e_t  Must be GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX.
  22.  
  23.      _r_e_s_e_t   If GGGGLLLL____TTTTRRRRUUUUEEEE, all entries in the minmax table that are actually
  24.              returned are reset to their initial values.  (Other entries are
  25.              unaltered.)  If GGGGLLLL____FFFFAAAALLLLSSSSEEEE, the minmax table is unaltered.
  26.  
  27.      _f_o_r_m_a_t  The format of the data to be returned in _v_a_l_u_e_s.  Must be one of
  28.              GGGGLLLL____RRRREEEEDDDD, GGGGLLLL____GGGGRRRREEEEEEEENNNN, GGGGLLLL____BBBBLLLLUUUUEEEE, GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____BBBBGGGGRRRR, GGGGLLLL____RRRRGGGGBBBBAAAA,
  29.              GGGGLLLL____BBBBGGGGRRRRAAAA, GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, or GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA.
  30.  
  31.      _t_y_p_e    The type of the data to be returned in _v_a_l_u_e_s.  Symbolic
  32.              constants GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP,
  33.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT, GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT,
  34.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV,
  35.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV,
  36.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV,
  37.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV,
  38.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV,
  39.              GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, and GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV
  40.              are accepted.
  41.  
  42.      _v_a_l_u_e_s  A pointer to storage for the returned values.
  43.  
  44. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  45.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx returns the accumulated minimum and maximum pixel values
  46.      (computed on a per-component basis) in a one-dimensional image of width
  47.      2.  The first set of return values are the minima, and the second set of
  48.      return values are the maxima.  The format of the return values is
  49.      determined by _f_o_r_m_a_t, and their type is determined by _t_y_p_e.
  50.  
  51.      No pixel transfer operations are performed on the return values, but
  52.      pixel storage modes that are applicable to 1-dimensional images are
  53.      performed.  Color components that are requested in the specified _f_o_r_m_a_t,
  54.      but that are not included in the internal format of the minmax table, are
  55.      returned as zero.  The assignment of internal color components to the
  56.      components requested by _f_o_r_m_a_t are as follows:
  57.  
  58.                      ________________________________________
  59.                      IIIInnnntttteeeerrrrnnnnaaaallll CCCCoooommmmppppoooonnnneeeennnntttt   RRRReeeessssuuuullllttttiiiinnnngggg CCCCoooommmmppppoooonnnneeeennnntttt
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx((((3333GGGG))))
  71.  
  72.  
  73.  
  74.                     _________________________________________
  75.                      Red                  Red
  76.                      Green                Green
  77.                      Blue                 Blue
  78.                      Alpha                Alpha
  79.                      Luminance            Red
  80.                      ________________________________________
  81.  
  82.  
  83.      If _r_e_s_e_t is GGGGLLLL____TTTTRRRRUUUUEEEE, the minmax table entries corresponding to the return
  84.      values are reset to their initial values.  Minimum and maximum values
  85.      that are not returned are not modified, even if _r_e_s_e_t is GGGGLLLL____TTTTRRRRUUUUEEEE.
  86.  
  87. NNNNOOOOTTTTEEEESSSS
  88.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx is present only if GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg is returned when
  89.      ggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg is called with an argument of GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS.
  90.  
  91.      GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT is valid only if the EEEEXXXXTTTT____aaaabbbbggggrrrr extension is supported.
  92.  
  93. EEEERRRRRRRROOOORRRRSSSS
  94.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX.
  95.  
  96.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_o_r_m_a_t is not one of the allowable
  97.      values.
  98.  
  99.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not one of the allowable values.
  100.  
  101.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx is executed between the
  102.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  103.  
  104.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
  105.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV,
  106.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV and _f_o_r_m_a_t is not
  107.      GGGGLLLL____RRRRGGGGBBBB.
  108.  
  109.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
  110.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV,
  111.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV,
  112.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV,
  113.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV and _f_o_r_m_a_t
  114.      is not GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____BBBBGGGGRRRRAAAA or GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT.
  115.  
  116.  
  117. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  118.      ggggllllMMMMiiiinnnnmmmmaaaaxxxx, ggggllllRRRReeeesssseeeettttMMMMiiiinnnnmmmmaaaaxxxx, ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.